home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / sound / xmstr105.zip / XMASTER.DOC < prev    next >
Text File  |  1992-07-26  |  31KB  |  648 lines
  1. *----------------------------------------------------------------------------*
  2.  
  3.  
  4.  
  5.                 X - Master - The ULTIMATE in CONTROL for
  6.  
  7.                                 all your
  8.  
  9.                        EXTENSION specific programs
  10.  
  11.                                   v1.05
  12.  
  13. *----------------------------------------------------------------------------*
  14.  
  15. An introduction of sorts...
  16.  
  17. Scenario ONE -
  18.  
  19.         You own a Sound Blaster card, and you have been amassing
  20.     an enormous collection of MOD files, as well as a few ROL files, and 
  21.     a few CMF's.  You only have a 60mb HD, and have to keep all these 
  22.     files compressed as to conserve space.  Everytime you wish to play 
  23.     one of the MOD's, you have to uncompress the file, play it, and then 
  24.     delete it after hearing it.  Kind of a pain...
  25.  
  26. Scenario TWO -
  27.  
  28.         You own a VGA card and have been collecting a bunch of FLI's.  
  29.     These are incredible space takers, so keeping them unarchived does 
  30.     not make any sense, so you ARJ a few of them, ZIP some of the 
  31.     others, and LZH the rest.  Unfortunately, not one program can undo 
  32.     all the aforementioned archives, so you have to continually remember 
  33.     which one is compressed with which archive, or repeatedly take 
  34.     directories.  Even more of a pain, especially if you spell one 
  35.     wrong...
  36.  
  37. Scenario THREE -
  38.  
  39.         You own the ultimate multi-media machine and have the same 
  40.     problems as the two people mentioned above, but since you have a 
  41.     660mb HD, your problems are ten times worse!  What you need is a 
  42.     program which is easy to configure, will automatically choose which 
  43.     unarchiver and player to use, and give you the ability to play / 
  44.     view all the various extensions without the added headaches...
  45.  
  46. *----------------------------------------------------------------------------*
  47.  
  48. Enter X-MASTER
  49.  
  50.     X-MASTER is the program you need to aid you in combatting the above 
  51. scenarios.  So what is it, you might ask?  X-MASTER will give you a menu 
  52. to choose which file you wish to play / view / use.  If the file is 
  53. archived using one of the three most popular archivers, X-MASTER will 
  54. unarchive it for you to a place of your choosing, use the file as 
  55. directed, and then delete it once complete.  In the BBS' world, there 
  56. are so many programs that do different things, but programs can usually 
  57. be classified by their three character extension (i.e. .ZIP files are 
  58. usually compressed with PKZIP by Phil Katz; .MOD files are usually Amiga 
  59. Music files which require an external program, such as MODPLAY, to 
  60. use...)  Generally speaking, most people keep all there MOD's, VOC's, 
  61. FLI's, etc... in a particular directory, a default directory in other 
  62. words.  X-MASTER has the following features :
  63.  
  64.         ■  Easy to configure
  65.         ■  Support for ARJ'ed, LZH'ed and ZIP'ed files
  66.         ■  Mouse support
  67.         ■  An attractive display with an easy to operate menu
  68.         ■  Ability to sort files by extension/name
  69.         ■  Supports any and all extensions / players / viewers which 
  70.             support a command line option (or not!)
  71.         ■  Supports multiple directories of the same extension
  72.         ■  Ability to delete files from archives without leaving
  73.             the program
  74.         ■  Support for multiple players / viewers
  75.         ■  Speedier than the average program by using special
  76.             AutoMagic files
  77.         ■  Will unarchive the file where ever you wish including
  78.             a RAMDRIVE for added speed
  79.         ■  Ability to "tag" files for playing / viewing to create
  80.             a jukebox or video show
  81.         ■  Can compile several directories worth of same extension'ed 
  82.             files into one big list
  83.         ■  Support for 25/43/50 line modes
  84.         ■  Support ZIP/ARJ file comments for describing the file
  85.         ■  Supports XMS/EMS/DISK
  86.  
  87. *----------------------------------------------------------------------------*
  88.  
  89. Getting Started
  90.  
  91.     X-MASTER was made to be a simple program to use, but it requires the 
  92. use of many external programs for all features to be implemented.  
  93. Examine the included XMASTER.CFG file, and change it to suit your 
  94. system, and file names.  You might be able to use the configuration file 
  95. without any changes.  The setup of the configuration file is as
  96. follows :
  97.  
  98. drive / directory to unarchive file
  99. location of PKZIP
  100. location of PKUNZIP
  101. parameters for PKUNZIP
  102. location of LHArc
  103. parameters for LHArc
  104. location of ARJ
  105. parameters for ARJ
  106. first extension for X-MASTER to find  (i.e. MOD)
  107. location of the first extension files   (i.e.  C:\MODS)
  108. second extension for X-MASTER to find   ...
  109. location of the second extension files
  110. .
  111. .
  112. .
  113. (up to forty extensions allowed!)
  114.  
  115.     The lines which require filenames MUST be valid filenames, 
  116. regardless of whether or not you use the particular archiver.  The 
  117. parameter lines may be blank or not (PKUNZIP normally does not require 
  118. any parameters).  The location of where to unarchive files MUST be a 
  119. valid directory.  If the line is blank, the current directory will be 
  120. used.  Furthermore, do not put any extraneous spaces or lines between 
  121. the directory names, or file names.
  122.  
  123.     The last lines of the configuration file are the extensions you wish
  124. X-MASTER to recognize.  Example :  MOD, FLI, GL, GIF, VOC.  The line 
  125. following the extension is the default directory where to find the 
  126. aforementioned extensions.  Example : D:\TRAK, E:\VGA\FLIES, C:\PORNO, 
  127. D:\SB\VOCS...  Notice that none of the directories have a trailing 
  128. backslash; trailing backslashes are not necessary, but will be ignored 
  129. if present.  Put only one extension on each line, and you may have only
  130. one default directory for each extension.
  131.  
  132.     After completing the configuration file, you are halfway done.  You 
  133. must now make a batch file for each extension you put in the con-
  134. figuration file.  The purpose of the batch file is to actually "use" 
  135. (play / view / whatever) the file of your selection.  For example, say 
  136. you have a FLI extension in your configuration file, and to view the 
  137. FLI's, you use the program AAPLAY.EXE.  The batch file would be similar 
  138. to :
  139.  
  140. rem This batch file plays FLI's using AAPLAY
  141. E:\VGA\FLIES\AAPLAY %1
  142.  
  143.     Notice that a %1 is in place of where the name of the FLI to view 
  144. usually goes.  X-MASTER will pass the name of the FLI by use of DOS 
  145. parameters to the batch file.  If you are unsure of how the %variable 
  146. notation works, consult your DOS manual.  For most purposes, just place 
  147. a %1 where you would normally place the name of the file.
  148.  
  149.     So, how does X-MASTER know which batch file to run??  Well, the name 
  150. of the batch file has to be exact for X-MASTER to find it, and it must 
  151. follow a very special format.  Each batch file is named by the 
  152. extension for which it is going to be used, the word "PLAY" and then a 
  153. number starting at "1" and going through "9", ending with the .BAT 
  154. extension.  For example : "FLIPLAY1.BAT" would be the first (default) 
  155. batch file to be used to view .FLI files.  Always start with "1" and go 
  156. up from there.  You may have up nine batch files available.
  157.  
  158.     You might be wondering how you can tell the batch files apart when 
  159. your inside X-MASTER.  Did you notice the "rem" statement in the batch 
  160. file given earlier?  REM statements are simply "rem"arks made about the 
  161. batch file.  They do nothing to alter the operation of a batch file.  
  162. If you put a "rem" statement as the first line of your batch file, 
  163. X-MASTER will show the first forty characters following the "rem " 
  164. instead of an ambiguous "Batch file #2".
  165.  
  166. *----------------------------------------------------------------------------*
  167.  
  168. Notes on batch files
  169.  
  170.     Batch files can be very powerful, however, you must take care in 
  171. using them.  If you load a program into memory, it must be taken out of 
  172. memory before it will come back to X-MASTER.  This is especially 
  173. important when working with TSR programs.  I personally use KEY-FAKE a 
  174. lot (stuffs keys into the keyboard buffer) but it must be taken out of